Skip to content

Clarify OpenHands LLM Key vs OpenHands API Keys - #429

Merged
enyst merged 3 commits into
mainfrom
clarify-ohcloud-llm-api-key-usage
Apr 1, 2026
Merged

enyst merged 3 commits into
mainfrom
clarify-ohcloud-llm-api-key-usage

Conversation

@DevinVinson

@DevinVinson DevinVinson commented Apr 1, 2026 •

Copy link
Copy Markdown
Member
  • I have read and reviewed the documentation changes to the best of my ability.
  • If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes
A couple of small changes to help anyone who may be using the OpenHands (Cloud) API Keys instead of the LLM Key when building with the SDK.

  1. I added the need for credits in the SDK getting started OpenHands Cloud accordion and added OpenHands so it matches the API Keys page a bit more.
  2. I also changed the language in the OpenHands LLM entry with SDK so it matches the API Keys page. OpenHands API key -> OpenHands LLM API key.
  3. In the Configuration I added a warning that includes the error you'll get if you've used the wrong key to help anyone searching for the error find this entry. It matches a few other instances found in slack where others ran into the same error.

@mintlify

mintlify Bot commented Apr 1, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
all-hands-ai 🟢 Ready View Preview Apr 1, 2026, 4:31 PM

## Using OpenHands LLM Provider with the SDK

You can use your OpenHands API key with the [OpenHands SDK](https://docs.openhands.dev/sdk) to build custom agents and automation pipelines.
You can use your OpenHands LLM API key with the [OpenHands SDK](https://docs.openhands.dev/sdk) to build custom agents and automation pipelines.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good find!

Comment thread openhands/usage/llms/openhands-llms.mdx Outdated
Comment thread openhands/usage/llms/openhands-llms.mdx Outdated
Unable to find token in cache or `LiteLLM_VerificationTokenTable`
```

You can create multiple OpenHands API Keys to work with the [Cloud API](https://docs.openhands.dev/openhands/usage/cloud/cloud-api) but there is only one OpenHands LLM API Key for your account.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK, then how do you feel about only a tiny detail like

Suggested change
You can create multiple OpenHands API Keys to work with the [Cloud API](https://docs.openhands.dev/openhands/usage/cloud/cloud-api) but there is only one OpenHands LLM API Key for your account.
You can create multiple OpenHands Cloud API Keys to work with the [Cloud API](https://docs.openhands.dev/openhands/usage/cloud/cloud-api) but there is only one OpenHands LLM API Key active at any time for your account.

I think I can see then why the number... kinda helps differentiate them a little further, so let's keep it. 🤔

Remove language about only one LLM API key

Co-authored-by: Engel Nyst <engel.nyst@gmail.com>

@enyst enyst left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

I think maybe we'll get back to this, but I'm confident it already helps with the confusion out there! 😅

@enyst
enyst merged commit 60f0aeb into main Apr 1, 2026
4 checks passed
@enyst
enyst deleted the clarify-ohcloud-llm-api-key-usage branch April 1, 2026 16:53
@DevinVinson

Copy link
Copy Markdown
Member Author

Thanks @enyst !

This branch was successfully deployed

1 active deployment
staging — c3eb212c Deployed Apr 1, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants